package com.zishuimuyu.trans;

/**
 * 定义一个翻译器接口，该接口规定了翻译器需要实现的基本功能。
 * 任何实现此接口的类都需要提供将指定源语言的文本翻译为目标语言的功能。
 */
public interface Translator {
    /**
     * 将指定源语言的文本翻译为目标语言。
     *
     * @param from  源语言，使用 LANG 枚举类型表示。
     * @param targ  目标语言，使用 LANG 枚举类型表示。
     * @param query 需要翻译的文本内容。
     * @return 翻译后的文本。
     * @throws Exception 如果在翻译过程中发生异常，例如网络问题、API 调用失败等。
     */
    // 注意：接口中的方法默认是 public 的，这里的 public 修饰符是多余的，可以移除
    public String trans(LANG from, LANG targ, String query) throws Exception;
}
